机会代币列表
接口描述
获取AI通过多维度数据，追踪当前行情下具有上涨潜力的代币列表。
使用场景：
- 适用于当前行情下存在上涨行情机会的代币筛选和查询
- 适用于中短线交易者寻找具有上涨潜力的代币标的
- 适用于趋势跟踪策略中识别潜在上涨机会
使用提示：
- 自然语言输入中长线投资、机会看涨、看涨、利多等词语时可查询此接口
- 自然语言输入上涨机会、看涨代币等语言时可查询此接口，返回结果需注明机会看涨监控代币
数据更新频率：每5分钟更新一次
请求URL
- 方法：
POST - 路径：
/open/v1/ai/getChanceCoinList
积分消耗
- 消耗积分：
3
前置条件
无前置条件，可直接调用。
请求参数
参数通过请求体（Body）以 JSON 格式传递。
无请求参数。
响应字段
仅展示 data 数组内每个对象的字段结构：
| 字段 | 类型 | 实际返回类型 | 描述 |
|---|---|---|---|
| vsTokenId | long | string | 代币 ID |
| symbol | string | string | 币种符号 |
| price | number | string | 当前价格 (USD) |
| maxPrice | number | string | 历史最高价格 (USD) |
| minPrice | number | string | 历史最低价格 (USD) |
| percentChange1h | number | string | 1 小时价格变化百分比 |
| percentChange24h | number | string | 24 小时价格变化百分比 |
| percentChange7d | number | string | 7 天价格变化百分比 |
| percentChange30d | number | string | 30 天价格变化百分比 |
| percentChange60d | number | string | 60 天价格变化百分比 |
| percentChange90d | number | string | 90 天价格变化百分比 |
| cost | number | string | 主力成本价格 (USD) |
| costChange | number | string | 成本变化率 |
| deviation | number | string | 价格偏离度 (%) |
| marketCap | number | string | 市值 (USD) |
| marketCapRanking | integer | integer | 市值排名 |
| circulatingSupply | number | string | 流通供应量 |
| circulationRate | number | string | 流通率 (%) |
| active | integer | string | 24h 活跃地址数 |
| newly | integer | string | 24h 新增地址数 |
| tradeType | integer | integer | 交易类型（1:现货 2:合约 3:交割合约） |
| chanceCoinTradeDataV1Vos | array | array | 交易时间数据列表 |
| timeRange | string | string | 时间范围标识（如 m15, H4） |
| timeParticleEnum | integer | integer | 时间粒度枚举值 |
| tradeInflow | number | string | 交易净流入金额 (USD) |
| tradeAmount | number | string | 交易总金额 (USD) |
| updateTime | long | long | 更新时间（毫秒时间戳） |
| pushPrice | number | string | 入场推送价格 (USD) |
| pushMaxPrice | number | string | 推送后最高价 (USD) |
| gains | number | number | 推送后涨幅 (%) |
| pushMinPrice | number | string | 推送后最低价 (USD) |
| declines | number | number | 推送后跌幅 (%) |
| score | number | number | AI 综合评分 |
| scoreChange | number | number | 评分变化 |
| grade | integer | integer | 机会等级 |
| alpha | boolean | boolean | 是否 Alpha 信号 |
| fomo | boolean | boolean | 是否 FOMO 状态 |
| fomoEscalation | boolean | boolean | 是否 FOMO 加剧 |
| bullishRatio | number | number | 看涨情绪比例 |
| bearishRatio | number | number | 看跌情绪比例 |
字段业务含义
以下字段需要特别说明其业务含义和计算逻辑：
| 字段 | 业务含义 | 范围/计算方式 | 使用建议 |
|---|---|---|---|
| cost | 主力成本价格 | 根据大额交易加权计算的主力持仓成本 | 当前价格低于成本价时可能是买入机会 |
| deviation | 价格偏离度 | (当前价格 - 主力成本) / 主力成本 * 100% | 负值表示低于成本，正值表示高于成本 |
| score | AI 综合评分 | 范围 0-100，基于资金流、技术指标等综合计算 | 评分 < =45或评分>=80：待观察代币；45 < 评分 < 55：观察代币； 55 < 评分 < 80：机会代币； |
| grade | 机会等级 | 范围 1-3，3 为最高等级 | 等级越高表示风险越高 |
| pushPrice | 入场推送价格 | 系统首次推送该机会代币时的价格 | 用于计算入场后的涨跌幅 |
| gains | 推送后涨幅 | (pushMaxPrice - pushPrice) / pushPrice * 100% | 推送后的最大涨幅 |
| declines | 推送后跌幅 | (pushPrice - pushMinPrice) / pushPrice * 100% | 推送后的最大跌幅 |
| alpha | Alpha 信号 | 布尔值，表示是否具有超额收益潜力 | true 时关注度应更高 |
| fomo | FOMO 信号 | 布尔值，表示市场情绪是否过热 | true 时需警惕追高风险 |
| fomoEscalation | FOMO 加剧 | 布尔值，FOMO 状态进一步升级 | true 时风险显著增加 |
| active | 24h 活跃地址数 | 过去 24 小时内有交易的链上地址数量 | 反映市场参与热度 |
| newly | 24h 新增地址数 | 过去 24 小时内首次持有该代币的地址数量 | 反映新资金流入 |
| bullishRatio | 看涨情绪比例 | 范围 0-1，基于社媒分析 | 越接近 1 表示市场越看涨 |
| bearishRatio | 看跌情绪比例 | 范围 0-1，基于社媒分析 | 越接近 1 表示市场越看跌 |
| tradeInflow | 交易净流入 | 正值为资金流入，负值为资金流出 | 持续正值表示主力在吸筹 |
枚举值说明
tradeType - 交易类型
| 值 | 含义 |
|---|---|
| 1 | 现货 |
| 2 | 合约（永续） |
| 3 | 交割合约 |
timeParticleEnum - 时间粒度
| 值 | 含义 |
|---|---|
| 5 | 5 分钟 |
| 15 | 15 分钟 |
| 30 | 30 分钟 |
| 101 | 1 小时 |
| 104 | 4 小时 |
| 124 | 24 小时 |
| 201 | 1 天 |
| 207 | 7 天 |
| 230 | 30 天 |
请求示例
json
{}cURL 示例（Linux/macOS）
bash
curl --location --request POST 'http://${host}/api/open/v1/ai/getChanceCoinList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{}'cURL 示例（Windows CMD）
cmd
curl --location --request POST "http://${host}/api/open/v1/ai/getChanceCoinList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{}"成功响应示例
json
{
"code": 200,
"message": "success",
"data": [
{
"vsTokenId": "23335", // 代币 ID
"symbol": "THE", // 币种符号
"price": "0.2792", // 当前价格
"maxPrice": "4.10318040169636", // 最高价格
"minPrice": "0.07220387483514598", // 最低价格
"percentChange1h": "0.32799907", // 1 小时价格变化百分比
"percentChange24h": "1.41729409", // 24 小时价格变化百分比
"percentChange7d": "4.48765177", // 7 天价格变化百分比
"percentChange30d": "7.90282167", // 30 天价格变化百分比
"percentChange60d": "25.65261453", // 60 天价格变化百分比
"percentChange90d": "56.36890614", // 90 天价格变化百分比
"cost": "0.270901516998264831", // 成本价格
"costChange": "0.0625", // 成本变化
"deviation": "-1.418662", // 偏离度
"marketCap": "36026970.954971075", // 市值
"marketCapRanking": 312, // 市值排名
"circulatingSupply": "128932942.41721758", // 流通供应量
"circulationRate": "39.535394", // 流通率
"active": "347", // 活跃地址
"newly": "347", // 新增地址
"tradeType": 1, // 交易类型（1:现货 2:合约 3:交割合约）
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15", // 时间范围
"timeParticleEnum": 15, // 时间范围枚举值
"tradeInflow": "460.6252600000001", // 交易净流入金额
"tradeAmount": "3213.5094600000007" // 交易金额
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-338.09664999999995",
"tradeAmount": "4455.511570000001"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-5145.618659999999",
"tradeAmount": "37250.337159999995"
}
// ... 更多数据省略
],
"updateTime": 1773016500000, // 更新时间
"pushPrice": "0.2621", // 推送价格
"pushMaxPrice": "0.2806", // 推送最高价
"gains": 0.0, // 涨幅
"pushMinPrice": "0.2587", // 推送最低价
"declines": 1.297215, // 跌幅
"score": 45.0, // 当前评分
"scoreChange": 10.0, // 评分变化
"grade": 2, // 等级
"alpha": false, // 是否 alpha
"fomo": false, // 是否 FOMO
"fomoEscalation": false, // 是否 FOMO 加剧
"bullishRatio": 1.0, // 看涨比例
"bearishRatio": 0.0 // 看跌比例
},
{
"vsTokenId": "1831",
"symbol": "BCH",
"price": "471.1",
"maxPrice": "4355.6201171875",
"minPrice": "75.0753135706",
"percentChange1h": "-0.01774485",
"percentChange24h": "2.29847208",
"percentChange7d": "2.79498224",
"percentChange30d": "-7.7764893",
"percentChange60d": "-24.54350443",
"percentChange90d": "-18.72153828",
"cost": "292.505855607332520866",
"costChange": "2.446914",
"deviation": "-35.698867",
"marketCap": "9404123107.056818",
"marketCapRanking": 11,
"circulatingSupply": "20006718.75",
"circulationRate": "95.270089",
"active": "22924",
"newly": "22924",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "-22417.999600000003",
"tradeAmount": "68195.44840000001"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-30667.368100000003",
"tradeAmount": "107622.5285"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-100288.20520000004",
"tradeAmount": "1847100.6466"
}
// ... 更多数据省略
],
"updateTime": 1773025800000,
"pushPrice": "450.1",
"pushMaxPrice": "475.6",
"gains": 0.0,
"pushMinPrice": "442.6",
"declines": 1.666296,
"score": 65.0,
"scoreChange": 10.0,
"grade": 1,
"alpha": false,
"fomo": false,
"fomoEscalation": false,
"bullishRatio": 0.5455,
"bearishRatio": 0.0
},
{
"vsTokenId": "23635",
"symbol": "FORM",
"price": "0.29",
"maxPrice": "4.190275115870975",
"minPrice": "0.14300383150589102",
"percentChange1h": "1.00325051",
"percentChange24h": "8.34645515",
"percentChange7d": "0.43961778",
"percentChange30d": "48.34304224",
"percentChange60d": "-22.25867739",
"percentChange90d": "0.63458821",
"cost": "0.939513805854359157",
"costChange": "-0.253266",
"deviation": "218.155708",
"marketCap": "112311811.6419909",
"marketCapRanking": 155,
"circulatingSupply": "381867255.144574",
"circulationRate": "65.839182",
"active": "164",
"newly": "164",
"tradeType": 2,
"chanceCoinTradeDataV1Vos": [
{
"timeRange": "m15",
"timeParticleEnum": 15,
"tradeInflow": "-70934.94349000002",
"tradeAmount": "132642.78527"
},
{
"timeRange": "m30",
"timeParticleEnum": 30,
"tradeInflow": "-75774.15476000002",
"tradeAmount": "167235.10643999997"
},
{
"timeRange": "H4",
"timeParticleEnum": 104,
"tradeInflow": "-87347.62276",
"tradeAmount": "371051.104"
}
// ... 更多数据省略
],
"updateTime": 1773027600000,
"pushPrice": "0.2829",
"pushMaxPrice": "0.3109",
"gains": 0.0,
"pushMinPrice": "0.2627",
"declines": 7.140332000000001,
"score": 55.0,
"scoreChange": 10.0,
"grade": 1,
"alpha": false,
"fomo": false,
"fomoEscalation": false,
"bullishRatio": 0.5,
"bearishRatio": 0.0
}
// ... 更多数据省略
],
"requestId": "xxx-xxx-xxx"
}